- x, y
Vectors with x and y values. It is sufficient to pass the
ranges of the x- and y-values, as they will not be drawn.
If z
is a matrix, it is required that length(x) = nrow(z)
and
length(y) = ncol(z)
.
- z
Matrix or vector with z-values. If z
is a matrix,
it is sufficient to pass a diagonal matrix with the range of the z-values,
as they will not be drawn.
- bty
The type of the box; only effective if the persp
argument box
equals TRUE
(the default).
Unless bty
is equal to "u"
then the arguments
col.axis, col.panel, lwd.panel, col.grid, lwd.grid
will be ignored.
"f"
is the full box, the default as from persp,
"b"
has only the back panels visible, when "b2"
has back panels and grid lines, "g"
has grey background with white
gridlines, "bl"
has a black background,
"bl2"
has a black background with grey lines.
"u"
means that the user will specify the arguments
col.axis, col.panel, lwd.panel, col.grid, lwd.grid
manually.
"n"
means that no box will be drawn. This is the same as setting
box = FALSE
.
- col.axis, col.panel, col.grid
The color of the axis line, of the
axis panel or of the grid lines. Only used if bty = "u"
.
- lwd.panel, lwd.grid
The width of the panel border or of the
grid lines. Only used if bty = "u"
.
- theta, phi
The angles defining the viewing direction.
theta
gives the azimuthal direction and phi
the colatitude.
see persp.
- col
Colors to be used for coloring the colvar
variable.
Here only used for assessing if a color key should be drawn.
- colkey
A logical, NULL
(default), or a list
with parameters
for the color key (legend). List parameters should be one of
side, plot, length, width, dist, shift, addlines, col.clab, cex.clab,
side.clab, line.clab, adj.clab, font.clab
and the axis parameters at, labels, tick, line, pos, outer, font, lty, lwd,
lwd.ticks, col.box, col.axis, col.ticks, hadj, padj, cex.axis, mgp, tck, tcl, las
.
The defaults for the parameters are side = 4, plot = TRUE, length = 1, width = 1,
dist = 0, shift = 0, addlines = FALSE, col.clab = NULL, cex.clab = par("cex.lab"),
side.clab = NULL, line.clab = NULL, adj.clab = NULL, font.clab = NULL
)
See colkey.
The default is to draw the color key on side = 4, i.e. in the right margin.
If colkey
= NULL
then a color key will be added only if col
is a vector.
Setting colkey = list(plot = FALSE)
will create room for the color key
without drawing it.
if colkey = FALSE
, no color key legend will be added.
- plot
Logical. If TRUE
(default), a plot is created,
otherwise the viewing transformation matrix is returned (as invisible).
- ...
additional arguments passed to persp.
The following persp arguments can be specified:
xlim, ylim, zlim, xlab, ylab, zlab, main, sub, r, d,
scale, expand, box, axes, nticks, ticktype
.
Arguments scale
and expand
affect the size of the axes.
The arguments after ... must be matched exactly.